Skip to content

Add HttpOnly flag to synthetic ID cookie#507

Open
prk-Jr wants to merge 4 commits intomainfrom
fix/synthetic-id-cookie-httponly
Open

Add HttpOnly flag to synthetic ID cookie#507
prk-Jr wants to merge 4 commits intomainfrom
fix/synthetic-id-cookie-httponly

Conversation

@prk-Jr
Copy link
Collaborator

@prk-Jr prk-Jr commented Mar 16, 2026

Summary

  • The synthetic_id cookie was missing HttpOnly, allowing XSS on a publisher page to exfiltrate the tracking identifier via document.cookie.
  • HttpOnly is safe to add because no client-side JS reads this cookie — integrations receive the synthetic ID via the x-synthetic-id response header instead.
  • Adds debug_assert! guards against cookie metacharacter injection in both the synthetic_id value and cookie_domain, and documents the rationale for each security attribute in the function's doc comment.

Changes

File Change
crates/common/src/cookies.rs Add HttpOnly to cookie format string; add debug_assert! metacharacter guards; update doc comment to enumerate all security attributes with rationale

Closes

Closes #411

Test plan

  • cargo test --workspace
  • cargo clippy --all-targets --all-features -- -D warnings
  • cargo fmt --all -- --check
  • JS tests: cd crates/js/lib && npx vitest run — pre-existing ESM/CJS failure on main, unrelated to this change
  • JS format: cd crates/js/lib && npm run format
  • Docs format: cd docs && npm run format
  • WASM build: cargo build --bin trusted-server-fastly --release --target wasm32-wasip1
  • Manual testing via fastly compute serve

Checklist

  • Changes follow CLAUDE.md conventions
  • No unwrap() in production code — use expect("should ...")
  • Uses tracing macros (not println!)
  • New code has tests
  • No secrets or credentials committed

The synthetic_id cookie was missing the HttpOnly attribute, allowing
any XSS on a publisher page to exfiltrate the tracking identifier via
document.cookie.

HttpOnly is safe to set because integrations receive the synthetic ID
via the x-synthetic-id response header and no client-side JS reads it
from the cookie directly.

Also documents the rationale for each security attribute (Secure,
HttpOnly, SameSite=Lax, Max-Age) in the doc comment, and adds
debug_assert guards against cookie metacharacter injection in both
the synthetic_id value and cookie_domain.

Closes #411
@prk-Jr prk-Jr self-assigned this Mar 16, 2026
Copy link
Collaborator

@ChristianPavilonis ChristianPavilonis left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Review Summary

Clean, well-scoped security hardening. The HttpOnly addition is correct, the doc comment is excellent, and the change is minimal. One concern about the debug_assert! approach and a few smaller items below.

0 Blockers · 1 High · 3 Medium

Copy link
Collaborator

@ChristianPavilonis ChristianPavilonis left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@prk-Jr sorry the previous review didn't have clear suggestions.

Solid, well-scoped security fix. The HttpOnly addition is correct and the doc comment is excellent. Three actionable findings — two about the sanitization approach, one about the assert!.

Copy link
Collaborator

@ChristianPavilonis ChristianPavilonis left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approval

All findings from both review rounds have been addressed in the latest commit (2f3282f):

  • Runtime safety: debug_assert! and per-request assert! replaced with allowlist sanitization + log::warn! on modification, and #[validate] on Publisher::cookie_domain for fail-at-startup config validation.
  • Sanitization approach: Switched from denylist to allowlist (is_ascii_alphanumeric + . - _), which is more robust against unexpected metacharacters.
  • Test coverage: Sanitization, passthrough, and validator tests all added.
  • Documentation: Doc comments updated to reflect the new sanitization approach, with # Examples doctest included.

The follow-up to move sanitization upstream (to avoid the header/cookie value mismatch window) is tracked separately.

Looks good — nice work.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Synthetic ID cookie missing HttpOnly flag

2 participants